home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Language/OS - Multiplatform Resource Library
/
LANGUAGE OS.iso
/
cpp_libs
/
linklist
/
source.lha
/
doc
/
lFndFlagNode.3
< prev
next >
Wrap
Text File
|
1993-08-08
|
1KB
|
55 lines
'.so tmac.clman
.TH "lFndFlagNode"
.IX lFndFlagNode
.SH NAME
lFndFlagNode - Get node by flag.
.SH SYNOPSIS
int
.BR "lFndFlagNode" "(id, from, flag, data, size)"
.br
.RT
.RP
In int id identifier of linked list
.br
.RP
In int from from where must be searched
.br
.RP
In int flag flag of node which must be retrieved
.br
.RP
Out Byte *data data of node
.br
.RP
In int size size of data
.DT
.SH DESCRIPTION
\fBlFndFlagNode\fP searches a 'flagged' node from the linked list. From
where the node must be searched can be specified by \fIfrom\fP. A node
can be searched forward from the beginning of the list or from the
current node and backward from the current node or from the end of the
list.
.br
Backward searching is only possible for doubly linked list.
.br
When the found node is the first or the last node, the return code will
have the value lFIRST or lLAST, otherwise lFOUND.
.SH PARAMETER DEFINITIONS
.if t .ta 0.2i 1.5i
\fIfrom\fP :
.nf
lFIRST search forward from first node
lPREVIOUS search backward from previous node
lNEXT search forward from next node
lLAST search backward from last node
.fi
.SH RETURN CODES
.nf
Return on success :
lFOUND, lFIRST, lLAST, lNOT_FOUND
Return on error :
lUNKNOWN_ID, lEMPTY_LIST, lWRONG_FROM, lSIZE_NE
.fi
.SH AUTHOR
Anita Eijs (TNO - Bouw - BouwInformatica)